home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / util / misc / batchdecodev151.lha / decode.doc next >
Encoding:
Text File  |  1993-05-06  |  4.5 KB  |  149 lines
  1. May 4, 1993.
  2.  
  3. UUBatchDecoder v1.51 by Fletcher Cocquyt (fletcher@cs.ualberta.ca)
  4.  
  5.  
  6. Motivation:
  7.  
  8.    Tired of manually editing multi-parted uuencoded files, I 
  9.    decided to write this program to do all the drudgery for me.
  10.  
  11. What does it do?
  12.  
  13.    decode takes two arguments, a source directory and destination
  14.    directory and uudecodes the uuencoded files in the source dir
  15.    to the destination dir.  
  16.  
  17. How does it do that?
  18.  
  19.    In short, decode uses the Usenet Header format to decide which 
  20.    uuencoded parts belong to which uudecoded files.  It considers
  21.    every file in the source dir with a "Subject" line to be a
  22.    possible uuencoded file.  For the articles in the alt.binaries.
  23.    newsgroups, which follow the "standard" header format, decode 
  24.    has no problems decoding multiple part binaries, even when
  25.    they are in jumbled order (something most newsreaders won't
  26.    handle).
  27.  
  28. Syntax:
  29.  
  30.    decode [<source path> <destination path>]
  31.  
  32. TODO:
  33.  
  34.    Make a much enhanced version with GUI using MUI
  35.    (that's: Graphical User Interface using Stefan Stuntz's
  36.    soon to be released Magical User Interface -
  37.    check out his demo release it looks/works great!)
  38.  
  39. DISCLAIMER:
  40.  
  41.    I make no guarantee about the function of decode, and
  42.    as such can not be held responsible for any damages
  43.    possibly attributable to its use.  
  44.  
  45. Acknowledgements:
  46.  
  47.  o uudecode source was taken from uudecode.c last 
  48.    modified by R.W.Bowers on 88-01-25.
  49.  
  50.  o directory scan routine is based on example8.c in the 
  51.    AmigaDOS chapter of Anders Bjerin's ACM System v1.10
  52.  
  53.  o thanks to Tom Warkentin for supplying many uuencoded
  54.    files with which to test this program!
  55.  
  56.  
  57. History:
  58.  
  59. 1.51: May 4, 1993:
  60.  
  61.       Improved the file buffering to prevent memory fragmentation.
  62.       CTRL-c is disabled during decoding.  Added quit option.
  63.       First released version! 
  64.  
  65. 1.5:  Jan 22, 1993:
  66.  
  67.       Implemented file buffering.  Now only 32K is used to read in
  68.       the source files.  This allows decoding of any sized files.
  69.       500 lines are read in and decoded at a time.  
  70.  
  71.       New improvement: decode now will match subjects more 
  72.       intelligently, making sure its matching string is more
  73.       than 2 characters long.  Some series have Subject lines like:
  74.       Subject: - Kathy3.gif - SI 1993 Calendar (1/7) FEMALE
  75.       and the '-' would confuse decode when there was more than 
  76.       one series with such a '-' right after the Subject:.
  77.       Now decode will look at the next word in the line.
  78.       (This is largely untested, so I may have to revise this
  79.       if problems arise later).
  80.  
  81. 1.41: Jan 10, 1993:  
  82.  
  83.       Totally clean memory allocation/deallocation. 
  84.       Have not had any bugs with this version (yet).
  85.       The maximum file size is 65K, I plan to make this
  86.       dynamic later.
  87.  
  88. 1.4:  Jan 7, 1993:
  89.  
  90.       minor bug fixed where decode could mistake the "Message" 
  91.       line in the header for the first uuencoded line if it
  92.       was the right number of bytes long.  
  93.  
  94.       MAJOR efficiency increase achieved by loading whole
  95.       files into memory for faster decoding.
  96.       (I no longer recommend decoding from ram: to ram: since it
  97.       won't be any faster in the decoding stage).
  98.  
  99.  
  100. 1.3:  Jan 4, 1993:
  101.       
  102.       decode now ignores duplicate files.
  103.       This annoyance was brought to my attention by Tom Warkentin,
  104.       since sometimes a file will be posted twice and it confuses 
  105.       decode.  Not anymore!
  106.  
  107.       bug fixed where if no begin line was found the output stream
  108.       would miss being closed and when the next output was opened
  109.       caboom! ;) No more!
  110.  
  111. 1.2:  Jan 3, 1993:
  112.  
  113.       decode now ignores part 0's which are common in newsgroups.
  114.       Part zeros used to be taken as the first file to be decoded.
  115.       Now the lowest part number considered is 1.
  116.  
  117. 1.1   Jan 2, 1993:
  118.  
  119.       decode is now "smart", scanning the source dir for what it
  120.       considers uuencoded files and arranging them in what it 
  121.       thinks is the correct order based on the message subject 
  122.       line.  Many situations are left to be encountered.  I 
  123.       expect many revisions!
  124.  
  125. Address:
  126.  
  127. Internet: fletcher@cs.ualberta.ca
  128.  
  129.  
  130. Shareware Perpetuation:
  131.  
  132.    If you feel as though the author of this program, (or another)
  133.  
  134.    has saved you hours of tedious work by using his own expertise,
  135.    
  136.    why not consider registering his/her application.  This will
  137.  
  138.    (at least) give the "software engineer" in question a sense
  139.  
  140.    of accomplishment and help perpetuate the development of more
  141.  
  142.    innovative, time-saving applications.
  143.  
  144.  
  145.    Sincerely,
  146.  
  147.    Fletcher Cocquyt
  148.    (fletcher@cs.ualberta.ca)
  149.